home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d3 / clarion.arc / PTUTOR.HLP (.txt) < prev    next >
Clarion Help  |  1991-07-24  |  61KB  |  1,110 lines

  1.  This is the Base Window. 
  2.  Notice that
  3.  applications  
  4.  found in this 
  5.  directory are 
  6.  listed here. 
  7.  The bottom line lists seven options. 
  8.  /Run Selected Application
  9. Application: PHONES
  10. Files
  11.      Procedures
  12. MEMORY
  13. MAIN_MENU (Menu) - Directory Menu
  14. PHONES
  15. SHO_NAME (Table) - Directory by Name
  16. STATES
  17. UPD_PHONES (Form) - Update Directory
  18. SHOW_STATE (Table) - State Listing
  19. UPD_STATE (Form) - State Listing
  20. SHO_COMPANY (Table) - Directory by Company
  21. UPD_PHONES (Form) - Update Directory
  22. SHOW_STATE (Table) - State Listing
  23. UPD_STATE (Form) - State Listing
  24. RPT_NAME (Report) - Directory by Name
  25. RPT_COMPANY (Report) - Directory List by Company
  26. CARDS (Report) - Rolodex Cards
  27. LABELS (Report) - Mailing Labels
  28. RETURN
  29. Ins to Add
  30. Enter to Change
  31. Del to Delete
  32. Tables
  33. Main Menu
  34. Bright White On Blue
  35. MM/DD/YY
  36. Show File by Key  
  37.   Print File by Ke
  38.   Show File by Key  
  39. LOCATE:
  40. Update File
  41.   Prompt:
  42.   Prompt:<<,<<#.##
  43.   Prompt:MM/DD/YY
  44. Press B to toggle Blink
  45.   Add
  46. Enter
  47. / /!/"/#/$/%/&/'/(/)/*/+/,/-/.
  48. ?0?1?2?3?4?5?6?7?8?9?:?;?<?=?>
  49. O@OAOBOCODOEOFOGOHOIOJOKOLOMON
  50. _P_Q_R_S_T_U_V_W_X_Y_Z_[_\_]_^
  51. o`oaobocodoeofogohoiojokolomon
  52.  The black bar 
  53.  indicates the current application.  This applies to 
  54.  the [Run] and [Modify] options.  The bar can be moved with the Up 
  55.  and Down 
  56.  keys to select the desired application.
  57. The CLARION Personal Developer
  58. Introduction
  59. Files and Keys
  60. Procedures
  61. Using Quick Start
  62. A Preview of the Professional Developer
  63.      Please Choose a tutorial topic 
  64.  QRun
  65. Modify
  66. Create
  67. Options
  68. Import/Export
  69. Tutorial
  70.  This tutorial is presented in a page-by-page format. 
  71.  You may turn pages manually, or you may have them
  72.  turned automatically for you.
  73.  To continue, please press
  74. [M] for manual,
  75. [A] for automatic, or
  76. [Esc] to return to DOS.
  77.  Bill Smith
  78.  123 W. East St.
  79.  Coral Way, FL 
  80.  (305) 
  81. -1234
  82.  Birthday: 5/23
  83.  Mary Jones
  84.  765 N. West Rd.
  85.  Coral Way, FL 
  86.  (305) 776-8143
  87.  Birthday: 7/24
  88.  Peter Andrews
  89.  1021 E. 100th Way
  90.  Coral Way, FL 
  91.  (305) 775-5321
  92.  Birthday: 2/14
  93.  Nancy Mathews
  94.  1315 S. 200th Ave.
  95.  Coral Way, FL 
  96.  (305) 774-7891
  97.  Birthday: 9/30
  98.  Bill Smith
  99.  Nancy Mathews
  100.  Mary Jones
  101.  Peter Andrews
  102.  1021 E. 100th Ave.
  103.  Coral Way, FL 
  104.  (305) 775-5321
  105.  Birthday: 2/14
  106. Tables
  107. Main Menu
  108. Bright White On Blue
  109. MM/DD/YY
  110. Show File by Key  
  111. Track
  112.   Print File by Ke
  113. Fields
  114.   Show File by Key  
  115. Selected Field
  116. Tables
  117. LOCATE:
  118. Track
  119. Fields
  120. Prompts
  121. Forms
  122. Update File
  123. Track
  124. Prompts
  125.   Prompt:
  126. Fields
  127.   Prompt:<<,<<#.##
  128. Selected Field
  129.   Prompt:MM/DD/YY
  130. Message Field
  131.   Add
  132. Enter
  133.  If you have seen and understood the previous tutorials,
  134.  you now know enough to accomplish something useful with
  135.  Personal Developer.
  136.  After you have reviewed Chapter Two in your user's manual, 
  137.  and you have mastered the Quick Start method, move on to
  138.  Chapter Three.  In Chapter Three you will learn the
  139.  Custom Method of application design.
  140.  You will soon be familiar with the manner in which
  141.  Personal Developer applications are constructed.  Then
  142.  The [Create] option allows you to make a  
  143.  new application (one that does not appear 
  144.  in the list of applications found in this 
  145.  directory.)
  146.  5Design New Application
  147.  0Create
  148. Field
  149.   Field Name :ADDRESS
  150.   Description:Contact Address
  151.   Type
  152. :Character
  153.   Length
  154.   Picture
  155. :@s30
  156.   Choices
  157.   Type Mode  :AsIs
  158. Ins  Ovr  AsIs
  159.   Required
  160. Yes  No
  161.   Immediate  :No
  162. Yes  No
  163.   Num Lock
  164. Yes  No
  165.   Left Just  :No
  166. Yes  No
  167.   Upper Case :No
  168. Yes  No
  169. Record
  170. Address
  171.      City
  172. St  Zip
  173. Phone
  174. B-DayNumber
  175. Bill Smith
  176. 123 W. East St.
  177. Coral Way
  178. (305)
  179. -1234
  180. Mary Jones
  181. 765 N. West Rd.
  182. Coral Way
  183. (305)776-8143
  184. Peter Andrews  
  185. 1021 E. 100th Way 
  186. Coral Way
  187. (305)775-5321
  188. Nancy Mathews  
  189. 1315 S. 200th Ave.
  190. Coral Way
  191. (305)774-7891
  192. (PHONEBK.DAT)
  193. (ZIPCODE.DAT)
  194. Address
  195. Phone
  196. B-Day
  197. St  No
  198. Bill Smith
  199. 123 W.East St.
  200. (305)
  201. -1234
  202. 33064
  203. Pompano Bch
  204. Mary Jones
  205. 765 N.West Rd.
  206. (305)776-8143
  207. Coral Way  
  208. Peter Andrews
  209. 1021 E.100 Way
  210. (305)775-5321
  211. Nancy Mathews
  212. 1315 S.200 Ave
  213. (305)774-7891
  214. File: PHONES
  215. Prefix: PHN  
  216. Fields
  217.  ,Keys
  218. NAME (Character 30) - Name of Contact
  219. BY_NAME (Key)
  220. COMPANY (Character 30) - Company name
  221. ADDRESS (Character 30) - Contact Address
  222. CITY (Character 28) - Contact City
  223. BY_COMPANY (Key)
  224. STATE (Character 2) - Contact State
  225. COMPANY
  226. ZIP (Character 6) - Contact Zip Code
  227. PHONE (Numeric 10.0) - Contact Phone 
  228. Ins to Add
  229. Enter to Change
  230. Del to Delete
  231.  Personal Developer is a software package that lets you
  232.  conceive and create your very own programs (even if you
  233.  are not a programmer) to organize, maintain, and produce
  234.  reports on your data.
  235.  By "data" we simply mean any kind of related information
  236.  that is important to you.  A common example is a list of
  237.  names of people that you know along with their addresses,  
  238.  phone numbers, and even perhaps their birthdays and
  239.  anniversaries.
  240.  One way this sort of data can be organized is by noting
  241.  each person's information on a separate 3x5 card.
  242.  Many data base applications are more complicated than our 
  243.  example and require more than one data file.  Often the
  244.  information in one file is "related" to the information
  245.  in one or more other files.  We can say that there is a
  246.  "relationship" between the files.  When we design a
  247.  program to utilize those relationships we have what is
  248.  called a "relational data base" application.
  249.  In our example, we could notice that if 
  250.  our file becomes large, we could save
  251.  disk space by making a separate file to 
  252.  be used as a zip code table.  We could  
  253.  only store the zip code in our PHONEBK  
  254.  file and use it to "look-up" the city
  255.  and state when we need them.
  256.  Now the PHONEBK.DAT data file contains the Zipcode field
  257.  with the City and State fields part of a separate data
  258.  file, ZIPCODE.DAT.  The Zipcode field is used as a related 
  259.  field to look-up City and State.
  260.  The ZIPCODE file has a key file  
  261.  (ZIPCODE.K01) which uses the
  262.  Zipcode field as a key component.
  263.  You can look-up a City and State 
  264.  by using the Zipcode from
  265.  PHONEBK.DAT to locate a record
  266.  in ZIPCODE.DAT.
  267.  Many of the sample applications that come with Personal
  268.  Developer show examples of relating one or more files:
  269. [ORDER] - an inventory part number in an order file is
  270. used to look-up an item description and price.
  271. [TEACHER] - a student I.D. is used to look-up a
  272. student's full name.
  273. [TRACKING] - a company's name is used to retrieve its
  274. sales history from a sales tracking file.
  275. And there are many more examples.
  276.  Remember the Application Summary Window you saw
  277.  briefly in the introductory tutorial?
  278.  This is where you will begin the process of
  279.  designing data files and keys for your programs.  
  280.  To modify an existing file definition, you move
  281.  the selector bar to the desired file name and
  282.  press Enter.
  283.  Here you see the fields that make up the
  284.  records of this file.  Fields can be added to  
  285.  a file, deleted from a file, or you can change 
  286.  information about a field.  The bar is used to 
  287.  select a field.  If you press enter, the Field 
  288.  window will appear.
  289.  The Field window is where
  290.  you define the character-
  291.  istics of the fields in your 
  292.  file.  In later tutorials
  293.  you will learn about field
  294.  characteristics and how they 
  295.  affect screens and reports
  296.  that you design.
  297.  This side of the File window 
  298.  shows the keys 
  299.  that are used by your file.  New keys can be  
  300.  defined, or existing keys can be changed or
  301.  deleted.  The selector bar is used to point
  302.  to the desired key.  If you press Enter, the  
  303.  Key window will appear.
  304.  The Key window is where you name your key and 
  305.  define its special characteristics.  Again,
  306.  we will leave it to later tutorials to cover  
  307.  the meaning of each of the special key
  308.  characteristics.
  309.  We now have our important data  
  310.  recorded, but as a pile of
  311.  cards it is not very useful to  
  312.  We need to organize our data
  313.  into an ordered set called a
  314.  "file".
  315.  This concludes the tutorial on files and keys.  The goal
  316.  of this tutorial was to present to you a number of terms
  317.  and concepts that will be used in later tutorials and in
  318.  your user's manual.
  319.  Very little has been said yet about how to actually use
  320.  Personal Developer, but please be patient.  We will get
  321.  there very soon.  Before we do, however, please view one
  322.  more conceptual tutorial.
  323.  The next tutorial explains the concept of procedures.  You 
  324.  will build the programs that will use the files you design 
  325.  from building blocks called procedures.
  326.  We now have a "file".
  327.  It consists of a set of "records".
  328.  Each record is a set of related pieces 
  329.  of information called "fields".  For
  330.  example, the person's name is a field. 
  331.  And the street address is a field, and 
  332.  so is the city, etc.
  333.  Remember we said that our  
  334.  file was an "ordered" set. 
  335.  Without order, a data file 
  336.  isn't of much use.  We
  337.  chose to order this file
  338.  in alphabetic order by the 
  339.  "Name" field.
  340.  Ordering a file makes it
  341.  possible for us to quickly 
  342.  find a specific record.
  343.  In this case, we look up a 
  344.  record by name.
  345.  In our example, we gave order to our  
  346.  file via a process called sorting.
  347.  Sorting can be time consuming, but in 
  348.  this example it serves our purpose.
  349.  However, what if we want to be able
  350.  to keep our data ordered by more than 
  351.  one sequence.  Let's say we also want 
  352.  to be able to quickly locate a record 
  353.  by only knowing the phone number.
  354.  Now our 3x5 card system begins to
  355.  break down, and this is where your
  356.  computer and Personal Developer can
  357.  come to the rescue.
  358.  With Personal Developer, you design data files to contain your information.  
  359.  In this case, a single data file replaces our 3x5 cards.  With a data file
  360.  built by Personal Developer, you need not worry about the order in which the 
  361.  records are actually stored -- there is a better way.
  362.  r(PHONEBK.DAT)
  363.  With Personal Developer, after you
  364.  design your data file you then design 
  365.  a "key" for your file.
  366.  Your programs will use keys to
  367.  identify and order the records in
  368.  your data file.
  369.  Every data file you design will have  
  370.  at least one key.  When you design a  
  371.  key, you will specify which field (or 
  372.  fields) you want to use to order your 
  373.  records.  The program that you create 
  374.  will build the key for you and auto-  
  375.  matically keep the key entries in the 
  376.  correct order -- every time you add,  
  377.  change, or delete a record in your
  378.  data file.
  379.  Personal Developer allows
  380.  every file you design to
  381.  have as many keys as it
  382.  needs.  In our example, we
  383.  wanted to be able to find
  384.  records by phone number.
  385.  Now the solution is easy.
  386.  Simply design a second key
  387.  for your data file.  This
  388.  time, specify the "Phone"
  389.  field as the "key component" 
  390.  for identifying and ordering 
  391.  records.
  392.  We have now described what would become a data
  393.  file (PHONEBK.DAT) and two key files (PHONEBK.K01 
  394.  and PHONEBK.K02) on your disk drive.  Three disk  
  395.  files in all, but together, when you build a
  396.  program around them that lets you locate, add,
  397.  change, and remove records and print reports, you 
  398.  have what can be called a "data base".
  399.  The Import/Export function allows you to
  400.  convert dBaseII, dBase
  401. , DIF, and Comma- 
  402.  Delimited ASCII files into Clarion file
  403.  format, and vice-versa.
  404.  =Import and Export Files
  405.  LImport/Export
  406.  How to run this Tutorial 
  407.  You can change the viewing mode at any time by pressing 
  408.  for Manual
  409.  for Automatic
  410.  In either viewing mode 
  411.      the right arrow key  
  412.   turns to the next page, and 
  413.      the left arrow key
  414.   turns to the previous page. 
  415.  How to run this Tutorial (continued) 
  416.  In manual viewing mode, the tutorial waits for you to press one of the 
  417. page turning keys.
  418.  In automatic viewing mode, the tutorial gives you time to read a page, 
  419. then turns to the next page automatically.  
  420. You can speed up the tutorial by
  421. pressing the gray + key  
  422. slow down the tutorial by
  423. pressing the gray - key. 
  424. You can exit a tutorial by
  425. pressing the Esc key.
  426.  The next screen you see will be the Tutorial Main Menu.
  427.  The Tutorial Main Menu will offer you a choice of
  428.  tutorial topics.  Use the Up and Down arrow keys to
  429.  select the tutorial you wish to see.  Then press Enter to  
  430.  begin the selected tutorial.
  431.  We recommend that you view each tutorial, starting at the  
  432.  top of the list with "Introduction."  Then move down the
  433.  list, viewing each tutorial in its turn.  You may wish to  
  434.  view some of the tutorials more than once.
  435.  The tutorials will not take the place of your user's
  436.  manual, but we hope they help you get "up and going" with  
  437.  Personal Developer quickly.
  438.  Welcome to the Clarion Personal Developer -- your tool
  439.  for creating your own custom database applications.
  440.  You will find that creating applications with the
  441.  Personal Developer is fast and fun -- and you need no
  442.  prior programming knowledge.
  443. The power of the Personal 
  444.  Developer allows you to create a wide range of programs, 
  445.  each with your own "look and feel."
  446.  To load the Clarion Personal Developer 
  447. First, change the current directory to be the 
  448.      PCLARION directory.
  449. Then, type PCLARION and press Enter.
  450.  For example,
  451.  pressing Enter with 
  452.  the bar on PHONES
  453.  tells Personal
  454.  Developer to run
  455.  the Personal
  456.  Telephone Directory 
  457.  sample application. 
  458.  If you were to press Enter with  
  459.  the selector bar on PHONES, the  
  460.  Application window appears as
  461.  you see here.
  462.  Here you name your application,  
  463.  describe what it does, and name  
  464.  the procedure where you want
  465.  the program to start.
  466.  After entering the Application
  467.  window, the Application Summary  
  468.  window appears as you see here.  
  469.  This window displays a schematic 
  470.  of the files and procedures that 
  471.  make up the Personal Telephone
  472.  Directory sample application.
  473.  Don't worry about what all this  
  474.  means for now.  You will learn
  475.  more about files and procedures  
  476.  in their tutorials.
  477.   (PHONEBK.K01)
  478. Peter Andrews
  479. Mary Jones
  480. Nancy Mathews
  481. Bill Smith
  482.   (PHONEBK.K02)
  483. (305)774-7891
  484. (305)775-5321
  485. (305)776-8143
  486. (305)
  487. -1234
  488. (ZIPCODE.K01)
  489. 33064
  490.   Key Name
  491. :BY_NAME
  492.   Unique Key
  493. Yes  No
  494. Auto-number :No
  495. Yes  No
  496.   Case Sensitive:No
  497. Yes  No
  498.   Exclude Nulls :No
  499. Yes  No
  500. IINTRO   
  501. FFILES   
  502. PPROCS   
  503. UQUICK   
  504. APROF    
  505.  Introduction
  506. Files and Keys
  507. Procedures
  508.  !Using Quick Start
  509. A Preview of Professional Developer
  510.  The [Modify] option allows you
  511.  to make changes and enhancements 
  512.  to the indicated application.
  513.  6Modify Selected Application
  514.  "Modify
  515. Application
  516.   Application
  517. :PHONES.APP
  518.   Description
  519. :Personal Telephone Directory
  520.   Base Procedure:MAIN_MENU
  521. Modify Selected Application
  522.  ,Modify
  523.  If Enter is pressed on [Options], the 
  524.  Options window will appear.  There
  525.  are seven options you can set.
  526.  8Change Default Options
  527.  =Options
  528. Options
  529.   Directory Name
  530. :C:\PCLARION\
  531.   Create Listings
  532. Yes  No
  533.   Set Keyboard Locks
  534. Yes  No
  535.   Enhanced Keyboard
  536. Yes  No
  537.   Set Quick Start Colors:No
  538. Yes  No
  539.   Display Description
  540. Yes  No
  541.   Display Sign-on Screen:Yes
  542. Yes  No
  543.  KChange Default Options
  544.  GOptions
  545.  [Directory Name] shows the directory in which 
  546.  you are working.  You may enter a different
  547.  directory on this line.  Simply type in the
  548.  name of the directory and press Enter.
  549.  Personal Developer will validate the name you 
  550.  enter.
  551. C:\PCLARION\
  552.  When first starting the Personal Developer, an initial help 
  553.  screen appears providing helpful information for novice
  554.  users.  If you do not wish to see this screen each time you 
  555.  log on, select [No] for [Display Sign-on Screen].
  556.  This concludes the introductory tutorial.  This tutorial  
  557.  was intended to introduce you to the Personal Developer
  558.  Base window and its five options.  You should now proceed 
  559.  to the tutorial on Files and Keys where some important
  560.  concepts will be covered.
  561.  When you create or modify a program, Personal Developer writes your program  
  562.  in the Clarion programming language.  Clarion is a powerful, modern, high-
  563.  level computer language -- designed to easily produce the sort of programs
  564.  you will be creating.  If you specify [Yes] to [Create Listings], we make it 
  565.  possible for you to see the actual language statements of your program.  The 
  566.  next time your program is generated, a "listing" file will be created on
  567.  your disk drive.  The file will be named "<application name>.LST" and it may 
  568.  be printed on your printer or viewed with the DOS TYPE command.
  569.  Personal Developer will, at times, automatically set  
  570.  the state of the Scroll Lock, Num Lock, and Caps Lock 
  571.  keys.  This is intended to be for your convenience,
  572.  but you may disable this feature, if you wish, by
  573.  specifying [No] to [Set Keyboard Locks].  (Or, if
  574.  your keyboard fails to respond while you are running  
  575.  an application, try setting this line to [No].)
  576.  If your computer supports and uses an enhanced keyboard, 
  577.  select [Yes] at [Enhanced Keyboard].  This will enable
  578.  you to use the F11 and F12 keys in your application.
  579.  If your computer does not support or use an enhanced
  580.  keyboard, select [No].  (Or, if your keyboard fails to
  581.  respond while running an application, try setting this
  582.  line to [No].)
  583.  Personal Developer allows you to set the default colors or 
  584.  your quick start windows.  If you wish to change any of
  585.  your colors, move the selector to [Yes] and press Enter.
  586.  These are the quick start
  587.  windows that can be changed.
  588.  As you change colors, you can  
  589.  see how the colors will look
  590.  in the small windows here.
  591.  You simply move the selector
  592.  bar to the category of colors  
  593.  you wish to change and then
  594.  press Enter.
  595.  The active color is shown here 
  596.  and appears in a box on the
  597.  control screen.  The cursor
  598.  control keys are used to move
  599.  the box to the color you desire. 
  600.  Pressing Enter will set a new
  601.  active color on your quick start 
  602.  windows for the specified
  603.  category.
  604.  The description for each application is shown on the
  605.  Base window to the left of each app.  To speed up the
  606.  display of the Base window, this display of the des-
  607.  criptions can be turned off.  Select [No] for [Display  
  608.  Descriptions] if you don't want the descriptions shown. 
  609. The CLARION Personal Developer
  610. ASSETS
  611. - Home Inventory
  612. - Club Membership Roster
  613. LIBRARY  - Books, Video Tapes, and Music
  614. MEMOS
  615. - Interoffice Memo Writer
  616. ORDER
  617. - Order Entry System
  618. PHONES
  619. - Personal Telephone Directory
  620. TEACHER  - Grading and Class Organization
  621. TRACKING - Sales Tracking
  622. Modify
  623. Create
  624. Options
  625. Import/Export
  626. Tutorial
  627. Personal Telephone Directory
  628. Directory by Name
  629. Directory by Company
  630. Directory List by Name
  631.      Directory List by Company
  632. Rolodex Cards
  633. Mailing Labels
  634.  to point to the desired
  635. Function and ENTER to select
  636.  Instruction 1
  637.  Instruction 2
  638.  Instruction 3
  639.  Instruction 4
  640. (Procedure)
  641.  Instruction ?
  642.  Return
  643.  (Procedure "A")
  644. Instruction 1 
  645. (Procedure "B") 
  646. Instruction 2 
  647.  Instruction 1
  648.  Instruction 2
  649. (Call) "B" 
  650. . . .
  651. Instruction 4 
  652.  Instruction ?
  653. . . .
  654.  Return
  655. Instruction ? 
  656. Return
  657.  (Procedure "A")
  658. Instruction 1 
  659. (Procedure "B")
  660. (Procedure "C") 
  661. Instruction 2 
  662.  Instruction 1
  663.  Instruction 1
  664.  Instruction 2
  665.  Instruction 2
  666. (Call) "B" 
  667.  Instruction 3
  668.  (Call) "C" 
  669. Instruction 4 
  670.  Instruction 4
  671. . . .
  672.  Instruction 4
  673.  Return
  674. Instruction ? 
  675.  Return
  676. Return
  677. (Procedure "A")
  678.  ?Inst. 1 
  679. (Procedure "B")
  680. (Procedure "C")
  681. Inst. 2 
  682.  Instruction 1
  683.  Instruction 1
  684.  Instruction 2
  685.  (Call) "C" 
  686. Error !
  687.  "B" 
  688.  Instruction 3
  689.  (Call) "C" 
  690. Inst. 4 
  691.  (Call) "A" 
  692. Error !
  693.  Instruction 4
  694.  Return
  695. Inst. ? 
  696.  Return
  697.  'Return
  698.  Programs that you create with Personal Developer are made  
  699.  up of two important components: files and procedures.
  700.  Files were explained in the previous tutorial.
  701.  This tutorial will cover procedures.
  702.  Here is an
  703.  example of
  704.  how you might
  705.  design a menu
  706.  procedure to 
  707.  look.
  708.  A menu is a  
  709.  screen
  710.  procedure
  711.  that lets you
  712.  pick from a  
  713.  list of
  714.  "menu items".
  715.  When a menu  
  716.  item is
  717.  picked, a
  718.  corresponding
  719.  procedure is 
  720.  called.
  721.  Procedures
  722. called:
  723. > SHO_NAME
  724. > SHO_COMPANY 
  725. > RPT_NAME
  726. > RPT_COMPANY 
  727. > CARDS
  728. > LABELS
  729. > RETURN
  730.  This is the Application Summary
  731.  window.  You may remember seeing it
  732.  in the introductory tutorial, but it  
  733.  probably didn't mean much to you at
  734.  that time.  The schematic might now
  735.  start to make a little more sense.
  736.  Execution begins at the top of the
  737.  schematic with MAIN_MENU.  This is
  738.  what is known as the "base procedure".
  739.  The lines branching off from MAIN_MENU
  740.  show the procedures that are called
  741.  when a menu item is selected in the
  742.  menu procedure.
  743.  Here is an example of how a table procedure might look.
  744.  A table is a screen procedure that displays a scrollable
  745.  list of records from a file.  The selector bar is moved up 
  746.  and down with the Up and Down arrow keys.  The Enter key
  747.  is used to select a record.  A table procedure can specify 
  748.  an "update procedure" which gives it the ability to call a 
  749.  procedure to handle adding new records, or revising or
  750.  deleting existing records.
  751.  The schematic shows the table  
  752.  procedure SHO_NAME.  SHO_NAME  
  753.  calls UPD_PHONES, the update
  754.  procedure for the table.
  755.  You can see from the schematic 
  756.  that UPD_PHONES calls a
  757.  procedure named SHOW_STATE,
  758.  which in turn calls a procedure
  759.  named UPD_STATE.
  760.  This is UPD_PHONES, a form procedure and the update procedure called  
  761.  by SHO_NAME.  A form is a screen procedure where you can type data
  762.  into the fields of a file's record.  This type of screen is sometimes 
  763.  also called a data entry screen.
  764.  These characters are called "field prompts".  
  765.  Prompts help to show where a data entry field 
  766.  begins, and which field in the data file is
  767.  being entered.
  768.  These are the data entry fields of the 
  769.  form.  The first field is shown with
  770.  reversed colors because it is the
  771.  "selected field", or the field that is 
  772.  currently being entered.
  773.  A form procedure can also call another procedure.  This entry field has a
  774.  look-up procedure specified.  When you enter data into the state field, the  
  775.  look-up procedure is called.  Table procedures are often used as look-up
  776.  procedures.
  777.  This table procedure (used as a look-up procedure) also has an update
  778.  procedure.  These screen procedures show how two files can be related in
  779.  a program.  The PHONES and STATES files are related through the state code  
  780.  field.  While starting out to revise a phone book record, if necessary, you 
  781.  will have the ability to add a new state code.
  782.  Once you have decided how many data files you will need,
  783.  what keys they will have, and what fields will make up
  784.  their records, the next step is to decide what needs to
  785.  be done with this data.
  786.  For example, you will have to have ways of entering the
  787.  information so that records can be added to data files.
  788.  You will also need to be able to revise or delete existing 
  789.  records.  You probably have in mind reports you would like 
  790.  to have printed.  In order to accomplish these tasks, the  
  791.  computer needs to be given instructions.  The instructions 
  792.  must be very explicit.  The computer must be told every
  793.  step it must take and in what order to take each step.
  794.  update procedure for SHO_NAME 
  795.  look-up procedure
  796.  update procedure
  797.  The schematic shows you how these 
  798.  procedures are "hooked together". 
  799.  This menu item calls a procedure named RPT_NAME which is a 
  800.  report procedure.  A report procedure prints a report on
  801.  your printer.  A report can have a title page, a page
  802.  heading and page footing, and repeated rows of data which  
  803.  can be grouped, totaled, or averaged.
  804.  This is what the report looks like when 
  805.  it prints on your printer.
  806.  Mo |  9/01/88
  807. Personal Telephone Directory
  808. Page 1
  809. List by Name
  810.  &o |
  811.  O| Name
  812. Company
  813. Telephone
  814.  O| Callaway, Rob
  815. Acme Computer Products
  816. -1212
  817. 1020 W. 31st St
  818. Coral Way
  819. o | Garrison, Tom
  820. Wilson Distributing
  821. -4455
  822. 167 Plantation Rd.
  823.  "o |
  824. Coral Way
  825. | Harrison, Brian
  826.      Harrison Pool Service
  827. -6789
  828. 13 Scottish Blvd
  829. Coral Way
  830.  This concludes the tutorial on procedures.  As with the
  831.  files tutorial, the goal was to present to you a number of 
  832.  of terms and concepts that will be used in later tutorials 
  833.  and in your user's manual.
  834.  We still have said little about how to actually use
  835.  Personal Developer, but the wait is now over.
  836.  The next tutorial shows how to use Quick Start.  You will  
  837.  see how to begin to build programs using the file, key,
  838.  and procedure concepts you have learned thus far.
  839.  With a traditional programming language, it is the job of  
  840.  a programmer to write the instructions that make up the
  841.  program.  This process is time consuming, somewhat of an
  842.  art, and often hampered by human error.
  843.  With Personal Developer, the necessary statements of the
  844.  programming language are generated for you.  You will
  845.  denote major tasks to be done (not the individual steps)
  846.  and describe the way you want those tasks to work and how  
  847.  your screens and reports will appear.  Personal Developer  
  848.  will write the program, creating the language statements
  849.  needed to do the job in the most efficient manor.
  850.  The major tasks that you will be designing are 
  851.  called "procedures".
  852.  A procedure consists of a set of instructions. 
  853.  When these instructions are performed by the
  854.  computer we say that the computer is
  855.  "executing" the instructions.  (Or we can say  
  856.  that the procedure is being "executed.")
  857.  The last instruction to execute in a procedure 
  858.  is the "Return" instruction.  We say that a
  859.  procedure "returns" when it is finished.
  860.  Procedures must be named.  A  
  861.  procedure begins to execute
  862.  when an instruction "calls"
  863.  the procedure by its name.
  864.  In this example, when "A"
  865.  calls "B", procedure "A"
  866.  stops executing and procedure 
  867.  "B" begins to execute.
  868.  When "B" finishes it returns  
  869.  to the procedure that called  
  870.  it.  In this case, execution  
  871.  will begin again at the
  872.  instruction following the
  873.  point at which "B" was called.
  874.  Called procedures may call
  875.  other procedures.  There is
  876.  almost no limit to how "deep" 
  877.  this sort of calling can go,  
  878.  but there are some rules.
  879.  A procedure cannot call itself.
  880.  If it did it, it would find itself in an
  881.  "endless loop", calling itself forever  
  882.  -- chasing its tail, so to speak.
  883.  Likewise, procedure "C" cannot call "A" 
  884.  or "B" because they will cause "C" to
  885.  be called again.
  886.  Another case of endless tail chasing.
  887.  Personal Developer allows you to create four types of 
  888.  procedures in your programs:
  889.      Menus, Tables, Forms, and Reports.
  890.  Menus, tables, and forms are "screen procedures".
  891.  That is, they use the screen of your computer's
  892.  monitor to display information, and they use your
  893.  computer's keyboard to accept information from you.
  894.  A "report procedure" prints information on your
  895.  computer's printer.
  896. Name field 
  897. >Address field 
  898. >City, State, Zip field
  899. >Phone number field 
  900. Birthday field 
  901. File 
  902. Record 
  903.  (Record 
  904.  (Record 
  905.  (Record 
  906.   Use Quick Start?:Yes  Yes No  
  907.  If you press Enter
  908.  for the Create
  909.  option, the Quick 
  910.  Start option
  911.  window appears.
  912.  Quick Start is a  
  913.  fast way to create a simple application.  You can 
  914.  learn more about Quick Start in its tutorial.
  915.  >Design New Application
  916.  4Create
  917.  The last Base Window option is [Quit].  As  
  918.  you might expect, pressing Enter here will  
  919.  take you out of Personal Developer and
  920.  return you to DOS.
  921.  RExit to DOS
  922. Quit 
  923.  The [Run] option "runs" an application. 
  924.  -Run Selected Application
  925. Personal Telephone Directory
  926. State Listing
  927. FL  Florida
  928. GA  Georgia
  929. IA  Iowa
  930. IL  Illinois
  931. IN  Indiana
  932. KY  Kentucky
  933. MD  Maryland
  934. ME  Maine
  935. MO  Missouri
  936.  to point
  937. ENTER to select 
  938.  INS to add  DEL to delete  ESC to exit 
  939. Personal Telephone Directory
  940.   Listing by Name
  941.   Callaway, Rob
  942. Acme Computer Products
  943.      305/
  944. -1212  
  945.   Garrison, Tom
  946. Wilson Distributing
  947. -4455  
  948.   Harrison, Brian
  949. Harrison Pool Service
  950. -6789  
  951.   Johnson, Bill
  952. Dynamic Resorts, Inc.
  953. 305/837-4456  
  954.   Madison, Steve
  955. Coral Way Bank
  956. -7790  
  957.   Morrison, Alan
  958. MTD Software Services, Inc.
  959. -1176  
  960.   Nicholas, Randy
  961. Info-Tronic Subsystems, Ltd.
  962. 314/335-6749  
  963.   Patterson, Corry
  964. Floppy Disks Galore, Inc.
  965. 402/771-9648  
  966.   Shannon, Manny
  967. Indispensible Software
  968.      305/
  969. -3895  
  970.   Stanton, Bob
  971. Clarion Software
  972. 305/785-4
  973.   Woodson, Mary
  974. Acme Computer Products
  975.      305/
  976. -1212  
  977.  to point  ENTER to select  INS to add  DEL to delete
  978. Press ESC once to use locator field and again to exit to the menu.
  979.  And of course the tutorial option allows 
  980.  you to view these screens that you are
  981.  seeing now.
  982.  EPersonal Developer Tutorial
  983.  \Tutorial 
  984. Update Directory
  985. Record will be Changed
  986.   Name
  987. :Johnson, Bill
  988.   Company :Dynamic Resorts, Inc.
  989.   Address :56 Plum Ave
  990.   City
  991. :Largo
  992.   State
  993.   Zip
  994. :33050
  995.   Phone
  996. :305/837-4456
  997. State Listing
  998. Record will be Added
  999.   Code :
  1000.   State:
  1001. N(OONN
  1002. APPS    
  1003. APPWIN  .
  1004. ATTRS   
  1005. BAR     
  1006. BASE    
  1007. BEGIN   j
  1008. BLACK   
  1009. CARD1   
  1010. CARD2   =
  1011. CARD3   ]
  1012. CARD4   
  1013. CARDS   
  1014. COLORS  
  1015. CONC_W1 
  1016. CREATE  
  1017. FIELDWIN
  1018. FILE    
  1019. FILE2   
  1020. FILEWIN 
  1021. FILE_W1 
  1022. FILE_W10y:
  1023. FILE_W11g<
  1024. FILE_W12
  1025. FILE_W13
  1026. FILE_W14
  1027. FILE_W15GC
  1028. FILE_W16
  1029. FILE_W17
  1030. FILE_W18
  1031. FILE_W19SH
  1032. FILE_W2 QI
  1033. FILE_W20
  1034. FILE_W3 
  1035. FILE_W4 
  1036. FILE_W5 
  1037. FILE_W6 ]S
  1038. FILE_W7 
  1039. FILE_W8 
  1040. FILE_W9 
  1041. IMP_EXP 
  1042. INSTR1  
  1043. INSTR2  k`
  1044. INSTR3  
  1045. INTRO_W1
  1046. INTRO_W2Mi
  1047. INTRO_W3*j
  1048. INTRO_W4
  1049. INTRO_W5[l
  1050. KEY1    Zn
  1051. KEY2    
  1052. KEY3    
  1053. KEYWIN  
  1054. MENU    
  1055. MODIFY  
  1056. MODIFY2 
  1057. OPTIONS 
  1058. OPTWIN  
  1059. OPT_W1  
  1060. OPT_W10 0
  1061. OPT_W11 
  1062. OPT_W2  
  1063. OPT_W3  
  1064. OPT_W4  
  1065. OPT_W5  +
  1066. OPT_W6  9
  1067. OPT_W7  g
  1068. OPT_W8  
  1069. OPT_W9  
  1070. PCLARION
  1071. PHONES  
  1072. PROC1   
  1073. PROC2   Q
  1074. PROC3   
  1075. PROC4   
  1076. PROC_W1 
  1077. PROC_W10
  1078. PROC_W11
  1079. PROC_W12I
  1080. PROC_W13
  1081. PROC_W14#
  1082. PROC_W15
  1083. PROC_W16
  1084. PROC_W17
  1085. PROC_W18/
  1086. PROC_W19h
  1087. PROC_W2 
  1088. PROC_W20
  1089. PROC_W21
  1090. PROC_W22
  1091. PROC_W23
  1092. PROC_W3 
  1093. PROC_W4 
  1094. PROC_W5 
  1095. PROC_W6 
  1096. PROC_W7 
  1097. PROC_W8 
  1098. PROC_W9 
  1099. PT_FIELD
  1100. PT_FILE 
  1101. PT_RECS 
  1102. QUICK   o
  1103. QUIT    
  1104. RUN     Z
  1105. SHOW_STA 
  1106. SHO_NAME{
  1107. TUTOR   L
  1108. UPD_PHONq
  1109. UPD_STAT
  1110.